Skip to main content
POST
/
action
/
social_post_creator_generate_social_image_action
[SC4] Generate Social Image
curl --request POST \
  --url https://api-lr.agent.ai/v1/action/social_post_creator_generate_social_image_action \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image_style": "conceptual",
  "image_aspect_ratio": "portrait",
  "output_variable_name": "social_image",
  "prompt": "<string>",
  "topic": "<string>",
  "key_stat": "<string>",
  "key_quote": "<string>",
  "framework_desc": "<string>"
}
'
{
  "status": 123,
  "response": {}
}

Authorizations

​
Authorization
string
header
required

Bearer token from your account (https://agent.ai/user/integrations#api)

Body

application/json
​
image_style
enum<string>
default:conceptual
required
Available options:
conceptual,
data_stat,
quote_card,
infographic
​
image_aspect_ratio
enum<string>
default:portrait
required

Portrait (4:5) takes up more feed space on mobile.

Available options:
portrait,
square
​
output_variable_name
string
default:social_image
required

Variable name for the result (contains image_url).

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*$
​
prompt
string

Full text prompt for the image. If provided, this takes priority over the topic field. Use for custom prompts or when piping from another action.

​
topic
string

The post topic the image should relate to. Used when prompt is empty to auto-build a style-specific prompt.

​
key_stat
string

Only for Data/Stat style. The number or stat to highlight (e.g. '73% of brands...').

​
key_quote
string

Only for Quote Card style. The quote to render on the image.

​
framework_desc
string

Only for Infographic style. The process or framework to visualise.

Response

Successful response

​
status
integer<int32>

HTTP status code of the action response

​
response
object

Response data from the action